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Remapping controls per emulator 


Although you can configure the ‘generic’ controls within Batocera just fine, what if you wanted to 
change the controller configuration for just a specific emulator? Like say you wanted to move the Z 
trigger on the N64 core from L2 over to R2? This is the article for that. 


Things can get confusing really quickly when talking about controls in this abstract fashion, so here 
we will establish specific terminology that will be used throughout this article to refer to specific 
aspects: 


* Controller This is the physical, bonafide controller in your hands. This can essentially be 
anything, a PS4 controller, an Xbox 360 controller, a NES gamepad hooked up to GPIO pins, 
your keyboard, your mouse, your Wii Zapper, etc. As long as it's been configured in 
EmulationStation's "Configure a Controller" menu, it's a controller. 

Retropad This is the simulated virtual controller that RetroArch uses to interface with its cores. 
You can read more about that and its philosophy here (keep in mind that Batocera is the one 
doing the auto-configuring in this case, not RetroArch), but all you need to know for this article 
is that it assumes the physical layout of a PS3 controller with SNES face buttons. Not all 
emulators will use this virtual controller as is, but Batocera will attempt to keep its button IDs as 
similar to it as possible. Exceptions will be noted. 

System's controls These are the signals sent to the emulated system at the end of the 
pipeline. For instance, this would be the PlayStation's Cross, Square, Circle and Triangle 
inputs. 

Controls menu This is the menu accessed from going into Quick Menu ([HOTKEY] + e 3 
Controls. This handles how the emulated system (core) sees your controls. For example, if you 
wanted to change the N64's Z trigger from L2 on your controller to R2, this is where you would 
go to do that. Note that not all emulators, specifically non-libretro emulators, have this menu. 
Exceptions will be noted. 

EmulationStation Although not always the case, some controller settings are configured from 
within Batocera. These settings can typically accessed through the GAME SETTINGS ^ PER 
SYSTEM ADVANCED CONFIGURATION - «system name> before launching the game. 
These may include things like what type of device is connected to what port, whether Joy-2- 
Dpad is activated for non-analog controllers, what preset keyboard configuration is used, etc. 
dependent on the emulator. Some of these settings may be ignored when manually making an 
override in the emulator itself, so keep this in mind. Settings like this will be referred to as "ES's 
setting". 
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libretro cores 


For the majority of its emulators, Batocera employs the use of RetroArch cores. These are indicated 
by the “libretro” prefix being in front of it. You can select your system's emulator by going into its 
games list from the system menu, pressing [SELECT] to go into that system's VIEW OPTIONS ^ 
ADVANCED SYSTEM OPTIONS - «emulator». 


The great thing about libretro cores is that they all use the same interface, and are (mostly) 

compatible with everything you can change there. One useful consistent menu option is the Quick 

Menu > Controls menu, which we will be using to remap our controls. Let's use the PlayStation 
emulator for example. 


Let's say you wanted to swap the Circle and Cross buttons (very comman PI apareser -to-Western 


game control schemes). First, open the Quick Menu with [HOTKEY] + D and then go to the 
Controls menu item. 


4X» Quick Menu 


LJ On-Screen Overiay 


GI Video Layout 


Rewind 


Latency 


Overrides 


Then select your appropriate port (usually Port 1). You'll see the Retropad's virtual buttons on the left 
and the emulated system's controls on the right. 
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‘ Port 1 Controls 


dh D-Pad Up Hat #0 up (N/A), (Key: up) 


D-Pad Down Hat #0 down (N/A), (Key: down) 


D-Pad Left Hat #0 left (N/A), (Key: left) 


cR D-Pad Right Hat #0 right (N/A), (Key: right) 


* A Button [Right] 1 (N/A), (Key: x) 


8 Button (Down) O (N/A), (Key: z) 


X Button (Top) 3 (N/A), (Key: s) 


v Y Button (Left) 2 (N/A), (Key: a] 


- Select Button 6 (N/A), (Key: rshift] 


You can go into any Retropad virtual button and assign it to a system's control. 


‘ Port 1 - A Button (Right) 1 (N/A), (Key: x) 


D-Pad Ur 
D-Pad Down 
)-Pad Left 
D-Pad Right 


Cross 
Triangle 
Square 


Select 


eft Analog Y - 
Left Analog Y + 


ARMed #22) 


And there you go, feel free to alter the controls how you like them! 
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% Port 1 Controls 


D-Pad Up Hat #0 up (N/A), (Key: up} 
|^ D-Pad Down Hat #0 down (N/A), (Key: down) 
D-Pad Left Hat #0 left (N/A), (Key: left) 
cR D-Pad Right Mat #0 right (N/A), (Key: right) 


ve A Button (Right) 1 (N/A), (Key: x) 


8 Button (Down) 0 (N/A), (Key: z) 
X Button (Top) 3 (N/A), (Key: s) 
Y Button [Left] 2 (N/A), (Key: al 


Select Button 6 (N/A), (Key: rshift} 


However, you'll find that your remapping is lost upon exiting the emulator. To make these changes 
permanent, you must "Save Core Remap File" from the Controls menu. 


“is Controls 


Load Remap File 


Save Core Remap File 


Save Game Remap File 


t 
LÀ 
WR Save Content Directory Remap File 
c» 
L 


Turbe Fire 


Port 1 Controls 
ort 2 Controls 
Port 3 Controls 
Port 4 Controis 
Port 5 Controls 
Port 6 Controls 
Port 7 Controls 
Port B Controls 
Port 3 Controls 
tort 10 Control 


Port 11 Control 


Port 12 Contro 


cARMed (22) 


If you receive an error message saying something similar to “cannot save remap file”, 
check for these folders: 


e /userdata/system/configs/retroarch/inputs/ 
e /userdata/system/.config/retroarch/config/remaps/ 
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9 


If they don't exist, create them and try again. 


You can also save just the game or directory's remap. The directory's remap will apply to all games in 
the same named folder. 


In case you'd ever like to go back to the default settings, you can delete the remap file from this 
menu as well (you'll have to exit and re-enter the menu to see this). 


‘ Controls 


iX É g^! 


3 Controis 


Port 4 Controis 


ontrot 


You may have noticed the “Analog to Digital Type” setting. This setting is handled in ES as the 
Joystick-to-Dpad advanced system setting (or similarly named), however if you have a saved remap 
file then the setting in your remap file will take priority over ES's setting. 


Remap files are saved to /userdata/system/.config/retroarch/remaps/(core 


name)/(core/folder/game name).rmp (you will need to enabled "Show hidden folders/files" in 
your file manager to view this directory). 


libretro: PUAE/VICE 


Controls for these computer emulators are stored in its core options, accessed via Quick Menu > 
Options > RetroPad Mapping Options. These take whatever you have assigned to the equivalent 
button in the Controls menu to another controller layer unique to this core. 
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% Quick Menu 


I 
© 
Close Content 


' Screenshot 


Undo Load State 


Jndo Save State 


% Quick Menu 


Q Undo Load State 


© Undo Save State 


D Start Recording 


Start Streaming 


On-Screen Overlay 


Video Layout 
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Options 


CPU Compatibility 


CPU Cycle-exact Speed 


@ Media Options 


Hotkey Mapping Options 


RetroPad Mapping Options 


‘ RetroPad Mapping Options 


Then change your keymaps as appropriate. PUAE/VICE have decided to use the SNES layout for 


reference here, so A is Bis se”, X is and Y is 
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4X» RetroPad Mapping Options 


Once you're done, back out one menu and scroll up to Manage Core Options. 


4X» Options 


9, Manage Core Options 


# Automatic Model Options 


CPU Compatibility 


CPU Cycle-exact Speed 


# Media Options 


# Video Options 
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‘ Manage Core Options 


Active Options File 
Save Game Options 


Save Content Directory Options 


Reset Options 


To save the remapping for just this game, Save Game Options. Otherwise, to apply it to all games in 
the same folder as this game, Save Content Directory Options. 


‘ Manage Core Options 


Active Options File 
Save Game Options 
Delete Content Directory Options 


Reset Options 


MAME 


& ) Massively improve this section. 
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MAME machines can be remapped in-game: 


1. Press [Enter] or push in [L3] + [R3] to open up the MAME menu. 


2. Goto Input for this game and press [Enter] or E 


3. Select the desired input to remap and press [Enter]/e, followed by the key/button desired to 
remap to. 


o Inputs can be cleared by double-tapping [Enter] É instead. 


Remap configuration files are stored at \userdata\saves\mame\mame (version) \cfg\ 


Pad2key 


This functionality can help you create a per-game mapping of your controller to keyboard keys, in 
order to play games from old computers like Apple II, Sinclair or DOS and Windows games that are 
finicky with their joypad support. 


It can also, to some extent, be used to define additional emulator command shortcuts from the 
controller (such as force-closing the emulator with [Alt] + [F4], not advisable if you like having 
non-corrupted save data). 


Define a system-wide pad2key mapping 


The first thing to do is to select a game in the game list and press [SELECT], go to ADVANCED 
SYSTEM CONFIGURATION and select Create pad to keyboard configuration. 


OPTIONS 


CREATE PAD TO KEYBOARD CONFIGURATION 


V 
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If a game has a config setting for itself, it'll not use the system-wide config at all, so 
Q editing the system-wide config will have no effect on the game itself. 


From there, select a key for each button on your Batocera RetroPad for Player 1 and/or Player 2. 


PAD TO KEYBOARD CONFIGURATION 


PLAYER 1 


Select none 


Q To create a mapping to send a combination (“chord” or “combo”) instead of a single key, 


use to enter each of the initial keys in the combination, and use to enter the final 
key. 


Pad2key configuration file 


Once your pad2key configuration is done for a specific game, it stays saved as a padto.keys or 
game_name. keys file next to your rom/in your Windows game directory folder. For a system-wide 
configuration, it'll be saved in /userdata/system/configs/evmapy/system-name. keys. It is a 
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plain JSON file with. Example: 


{ 
"actions playerl": [ 
{ 
"trigger": [ 
"hotkey", 
Sesto 
1; 
"type": "key", 
"target": [ 
"KEY LEFTALT", 
"KEY F4" 
] 
}, 
{ 
"trigger": "up", 
"type": "key", 
"target": "KEY UP" 
}, 
{ 
"trigger": "down", 
"type": "key", 
"target": "KEY DOWN" 
}, 
{ 
"trigger": "a", 
"type": "key", 
"target": "KEY RIGHTSHIFT" 
} 
] 


Action profiles 


A singular keys file may contain the action profiles for multiple players. "actions player1" will 
contain the actions for player 1, "actions player2" for player 2 and so on. Each action profile 
contains its own unique set of triggers and targets. Example: 


{ 
"actions playerl": [ 
{ 
"trigger": [ 
"hotkey", 
"start" 
IE 
"type": "key", 
"target": [ 


"KEY LEFTALT", 
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"KEY F4" 
] 
ir^ 
{ 
"trigger": "up", 
"type": "key", 
"target": "KEY UP" 
} 
li 
"actions player2": [ 
{ 
"trigger": [ 
"hotkey", 
"start" 
l5 
"type": "key", 
"target": [ 
"KEY LEFTALT", 
"KEY F4" 
] 
irn 
{ 
"trigger": "up", 
"type": "key", 
"target": "KEY UP" 
} 


] 
} 


Remapping controls per emulator 


In Batocera v37 and above, light guns can also contain their own actions. These are unique to the 
light guns, and thus use their own actions profile: “actions gunl". Example: 


{ 
"actions gunl": [ 
{ 
"trigger": I 
"3", 
ngu 
lly 
"type": "key", 
"target": [ 
"KEY LEFTALT", 
"KEY F4" 
] 
} 
] 
} 
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Triggers 
Batocera Retropad names 


The gamepad buttons are referred to specific values, they are as follows: 


e D-Pad UP: "trigger": "up" 

e D-Pad DOWN: "trigger": "down" 

e D-Pad LEFT: "trigger": "left" 

e D-Pad RIGHT: "trigger": "right" 
e [START]: "trigger": "start" 

e [SELECT] : "trigger": "select" 


e $: "trigger": "b" 


: e. "trigger": "a" 
e e» : "trigger" : "y" 
©: "trigger": "x" 


e Left stick UP: "trigger": "joysticklup" 

* Left stick DOWN: "trigger": "joystickldown" 
e Left stick LEFT: "trigger": "joysticklleft" 

* Left stick RIGHT: "trigger": "joysticklright" 
* Right stick UP: "trigger": "joystick2up" 

e Right stick DOWN: "trigger": "joystick2down" 
* Right stick LEFT: "trigger": "joystick2left" 
* Right stick RIGHT: "trigger": "joystick2right" 
e [L1] : "trigger": "pageup" 

e [R1]: "trigger": "pagedown" 

e [L2]: "trigger": "l2" 

e [R2] : "trigger": "r2" 

e Push in [L3] : "trigger": "13" 

e Push in [R3] : "trigger": "r3" 

e [HOTKEY] : "trigger": "hotkey" 


Batocera light gun 


Most Batocera light guns will automatically map themselves as a virtual keyboard and pointer device, 
associating their ID with a particular player controller. More info on each individual light gun mapping 
can be found on the light gun page. 


e Primary fire: "trigger": "left" 
e Secondary fire: "trigger": "right" 
e [START] : "trigger": "middle" 

* Aux button 1: "trigger": "1" 

e Aux button 2: "trigger": "2" 

e Aux button 3: "trigger": "3" 

e Aux button 4 : "trigger": "4" 

e UP: "trigger": "5" 

* DOWN: "trigger": "6" 

e LEFT: "trigger": "7" 
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e RIGHT: "trigger": "8" 


Targets 


Keyboard key names 


The targeted keyboard key uses the same names as the ones reported by triggerhappy events they 
can be displayed using the thd - -Listevents command. Here are some examples: 


* Alphabetical keys 
o [A]: "target": "KEY A" 
o [Z]: "target": "KEY Z" 
e Number key (not the numpad) 
o [1]: "target": "KEY 1" 
o [0] : "target": "KEY 0" 
e Numpad keys 
o [0]: "target": "KEY NUMERIC 0" 
o [1]: "target": "KEY NUMERIC 1" 
o *: "target": "KEY NUMERIC STAR" 
e Function keys 
o [Esc] : "target": "KEY FN ESC" 
o [F1]: "target": "KEY FN F1" 
o [Enter] : "target": "KEY ENTER" 


External sources 


Alternatively Pad2keys config files can be scraped off screenscraper.fr, if the option is enabled for it. 
You can find some examples from the Content Downloader for Windows games like Ri-Li or Super 
Mario War, both with embedded pad2key config files. 


Launching commands with the pad2key 


As you saw earlier, the pad2key can be used to simulate keyboard presses, however, it can also be 
used to launch specific commands. Replace the "type" : “key” to "type" : “exec”, and set 
the "target" to the command. 


For example: 
1 
"trigger": [ 
"hotkey", 
"pageup" 
I, 
"Xype": "exec", 
"target": "batocera-screenshot" 
} 
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can be used to launch the batocera-screenshot command with the hotkey+L combo, effectively 
letting you screenshot in systems that don't support a screenshot feature, but that support the 
pad2key. 


DosBox standalone 


A part of the configuration of DosBox you can configure pad2key to assign your controller to keys on 
the virtual keyboard. This is especially useful for console-to-PC ports, but may not be as usable for 
games primarily focused on keyboard control. 


This can be achieved by creating a pad to keyboard configuration for Ja ous in EmulationStation. 
pe hovering over your intended game to configure, press and hold “e” to access this menu (press 
' in Batocera v30 and earlier). 


MORTAL KOMBAT TRILOGY (1997) 


CREATE PAD TO KEYBOARD CONFIGURATION 


If you'd like to configure a pad2key configuration for every DOS game, you can do so from the 
ADVANCED SYSTEM OPTIONS. Press [SELECT] while in the DOS gamelist. 
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DOS (X86) 


IDEO MONE 
IU 


CREATE PAD TO KEYBOARD CONFIGURATION 


BACK 


You can create this file manually by placing an appropriate pad2. key in the (game) .pc directory of 
the game. No need to change any configuration setting, this file simply being present will activate 
pad2key. If your game is in a zip file in the dos directory instead, place the pad2. key file in the dos 
directory alongside it and rename it to gametitle.zip.key, where gametitle is the name of the zip 
file. 


This is specifically for the standalone DosBox emulators. This will have no effect on the 
A libretro cores like libretro/DosBox Pure unless you also set 

dos.controllerl dosbox pure to 3 for "Custom keyboard bindings (best for 

Batocera Pad2Key)”. 


Here is an example pad2key mapping file for Mortal Kombat Trilogy: 


pad2.key 
{ 
"actions playerl": [ 

1 
"trigger": "up", 
"type": "key", 
"target": "KEY UP" 

}, 

1 
"trigger": "down", 
"type": "key", 
"target": "KEY DOWN" 

}, 

1 
"trigger": "left", 
"type": "key", 
"target": "KEY LEFT" 

}, 

1 
"trigger": "right", 
"type": "key", 
"target": "KEY RIGHT" 

}, 

{ 
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"trigger": "start", 


"type" 5 LLI key", 
"target": "KEY_ ENTER" 


l5 
{ 
"trigger": "select", 
"type": "key", 
"target": "KEY KP7" 
lu 
1 
"trigger": "a", 
"type": "key", 
"target": "KEY KP2" 
im 
{ 
"trxggeris "bs 
"type": "key", 
"target": "KEY KP1" 
iu 
1 
wt baggebss x 
"type": "key", 
"target": "KEY KP5" 
B 
1 
"triggers. sy 
"type": "key", 
"target": "KEY KP4" 
}, 
{ 
"trigger": "pageup", 
"type": "key", 
"target": "KEY KP6" 
E 
{ 
"trigger": "pagedown", 
"type": "key", 
"target": "KEY KP3" 
E 
{ 
"trigger": [ 
"hotkey", 
"start" 
IE 
"type": "key", 
"target": "KEY ESC" 
Us 
{ 
"trigger": [ 
"hotkey", 
uy" 
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IE 
"type" 2 il key" 5 
"target": "KEY F4" 


"trigger": [ 
"hotkey", 


y 
], 
"type": "key", 
"target": "KEY F5" 


Remapping controls per emulator 


The “trigger” is your Retropad controller; you shouldn't need to change this (“pageup” and 
“pagedown” refer to L1 and R1 respectively). The “target” is the virtual keyboard's key; feel free to 
change/swap these around. 


DosBox Pure automatically detects the game running and loads its own preset 


remapping process (recommended to use per-game remap file). If a game would rather 


es configuration. The libretro/DosBox-Pure core can use the standard libretro core 


benefit from complete control over the keyboard, press Scroll Lock to enable Game Focus 
mode (removes keyboard hotkeys). 


DosBox can also emulate having a joystick plugged into the virtual serial port by enabling the 
joysticktype line in dosbox.cfg, however due to lack of consistency between joystick 
manufacturers not all games implement all aspects of these joysticks completely/correctly. It's 
recommended to use pad2key for most games (only a very few games took advantage of analog 


controls). 


Mupen64Plus 


Unlike with the libretro core, remaps of the system's controls for the standalone Mupen64Plus can be 
configured by editing userdata/system/configs/mupen64/input. xml. Back up this file before 


making edits to it. When you open it, you'll see the bindings like so: 


input.xml 


<inputList> 


«input name-"AnalogDeadzone" value="0,0" /> 
"AnalogPeak" value="32768,32768" /» 
value-"Mempak switch" /> 
value-"Rumblepak switch" /» 
value="C Button R" 


«input name- 
«input name="13" 
«input name="r3" 
«input name-"a 
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«input name="b" value-"A Button" /» 
«input namez"x" value="C Button U" /» 
«input name="y" value-"B Button" /» 
«input name="start" value-"Start" /> 
«input name="select" value="" /» 

«input name="pageup" value-"L Trig" /» 
«input name="pagedown" value-"R Trig" /» 
«input namez"l2" value-"Z Trig" /» 
«input name="r2" value="" /» 

«input name="up" value-"DPad U" /» 
«input name="down" value-"DPad D" /» 
«input name="right" value-"DPad R" /» 
«input name="left" value="DPad L" /» 
«input name="joysticklup" value-"Y Axis" /» 


«input name-"joystickldown" value="Y Axis" /> 
«input name="joystickileft" value="X Axis" /> 
<input name="joystickiright" value="X Axis" /> 
<input name="joystick2up" value="C Button U" /» 
<input name="joystick2down" value="C Button D" /> 
<input name="joystick2left" value="C Button L" /» 
<input name="joystick2right" value="C Button R" /> 
</inputList> 


input.xml - V38 and later 


<inputList> 
<defaultInputList> 

«input name="AnalogDeadzone" value="0,0" /> 
<input name="AnalogPeak" value="32768,32768" /> 
«input name="13" value="Mempak switch" /> 
<input name="r3" value="Rumblepak switch" /> 
<input name="a" value="C Button R" /> 
<input name="b" value="A Button" /> 
<input name="x" value="C Button U" /> 
<input name="y" value="B Button" /> 
<input name="start" value="Start" /> 
<input name="select" value="" /» 
<input name="pageup" value="L Trig" /> 
<input name="pagedown" value="R Trig" /> 
«input name="12" value="Z Trig" /> 
<input name="r2" value="" /> 
<input name="up" value="DPad U" /> 
<input name="down" value="DPad D" /> 
<input name="right" value="DPad R" /> 
<input name="left" value="DPad L" /> 
<input name="joysticklup" value="Y Axis" /> 


<input name="joystickidown" value="Y Axis" /> 
<input name="joysticklleft" value="X Axis" /> 
<input name="joystickiright" value="X Axis" /> 
<input name="joystick2up" value="C Button U" /> 
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<input name="joystick2down" value="C Button D" /> 
«input name="joystick2left" value="C Button L" /> 
<input name="joystick2right" value="C Button R" /> 


</defaultInputList> 

<!-- Alt inputs for n64 style controllers --> 

<n64InputList> 
<input name="AnalogDeadzone" value="0,0" /> 
<input name="AnalogPeak" value="32768,32768" /> 
«input name="13" value="Mempak switch" /> 
<input name="r3" value="Rumblepak switch" /> 
<input name="a" value="B Button" /> 
<input name="b" value="A Button" /> 
<input name="x" value="C Button U" /> 
<input name="y" value="C Button L" /> 
<input name="start" value="Start" /> 
<input name="select" value="Z Trig" /> 
<input name="pageup" value="L Trig" /> 
<input name="pagedown" value="R Trig" /> 
«input name="12" value="C Button D" /> 
<input name="r2" value="C Button R" /> 
<input name="up" value="DPad U" /> 
<input name="down" value="DPad D" /> 
<input name="right" value="DPad R" /> 
<input name="left" value="DPad L" /> 
<input name="joysticklup" value="Y Axis" /> 


«input name="joystickldown" value="Y Axis" /> 
«input name="joysticklleft" value="X Axis" /> 
<input name="joysticklright" value="X Axis" /> 


<input name="joystick2up" value="" /> 
«input name="joystick2down" value="" /> 
<input name="joystick2left" value="" /> 
<input name="joystick2right" value="" /> 
</n64InputList> 
</inputList> 


The input names on the left are the Retropad inputs (“pageup” and "pagedown" refer to L1 and R1 
respectively). You don't typically need to edit these. 


The values on the right are the system's controls. Feel free to switch these around with each other. 
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Dolphin 


Remapping Dolphin's controls are a bit more involved, especially since it supports two major systems. 
It is recommended to watch Batocera Nation's excellent video tutorial on the subject, however a 
written guide is available below. 


Wii 


Firstly, if you'd like Batocera to handle emulated Wiimotes/Wii Classic Controller input, enable 
wii.emulatedwiimotes as described on this page. This works best for games that support control 
via the Wii Classic Controller or the GameCube Controller. This can also be saved on a per-game basis 
by utilizing configuration files. 


If you prefer to use Dolphin's interface for configuring controls instead of Batocera's preset 
configurations, read on. 


On the system menu, open Files with [F1] on the keyboard and navigate to Applications ^ 
dolphin-config. This will open Dolphin's menu. Navigate to Controllers in the toolbar (or press [F1] 
on the keyboard). 
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Ensure “Emulate the Wii's Bluetooth adapter" is checked, and that the first Wii Remote is set to 


“Emulated Wii Remote”, then click Configure. 


Controller Settings 


GameCube Controllers 
Port 1 Standard Controller " | Configure 
Port 2 Standard Controller ~ | Configure 
Port 3 Standard Controller d Configure 
Port 4 Standard Controller - Configure 
Wii Remotes 


Passthrough a Bluetooth adapter 


© Emulate the Wii's Bluetooth adapter 


Wii Remote 1 Emulated Wii Remote + [ conĝgure | 


Wii Remote 2 Real Wii Remote - 

Wii Remote 3 | Real Wii Remote M 

Wi Remote 4 | Real Wii Remote - 
Real Balance Board 


Enable Speaker Data 
¥ Connect Wii Remotes for Emulated Controllers 
v Continuous Scanning 
Common 


Background Input 


Alternate input Sources 


X Close 


This will open the controller configuration menu. Make sure the controller you intend to use is 
selected at the top-left of the window. For instance, here the Xbox controller is being selected to 
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emulate the Wiimote: 


| Device Reset Profile 
XInput2/0jVirtual core pointer Refresh | Default | Clear | | -| Load || save | Delete | 
evdev/0/Video Bus 
evdev/OfLite-On Technology Corp. USB Multimedia Keyboard E 
evdev/0/Lite-On Technology Corp. USB Multimedia Keyboard System Control Hotkeys Extension 
evdev/O/Lite-On Technology Corp. USB Multimedia Keyboard Consumer Control 
evdev/1/Lite-On Technology Corp. USB Multimedia Keyboard Sideways Toggle |. NM — E Les 
evdev/O/Logitech Wireless Mouse Upright Toggle Attach MotionPlus v 
evdev/O/Logitech Wireless Keyboard PID:4023 Sideways Hold end 
N eo we Conger NN Upright Hold 
All devices — Motor | 
+ 
HOME 
Í 
i i 
Options 
Speaker Pan | 0.00 % $ 
Battery | 95.00 % GE 
Upright Wii Remote 
Sideways Wii Remote = 


X Close 


Set up your emulated Wiimote as you'd like, and then save your profile in the top-right of the window. 


| Device Reset Profile 


evdev/O/Xbox Wireless Controller. E E =|| Refresh | Default Clear Xbox One iz] Load ]| save " F Delete | 


General and Options | Motion Simulation Motion input Extension Extension Motion Simulation ^ Extension Motion Input 


Buttons D-Pad Hotkeys Extension 
A _ SOUTH i Up Axis7- Sideways Toggle Nunchuk — am IR 
B EAST Down Axis7+ | Upright Toggle Attach MotionPlus v 

| 1 = _ NORTH Left à Axis6- | Sideways Hold P — nimbis 
2 WEST Right Axis6+ | Upright Hold 
ee "Lc d Motor | 

- BACK 
* START 


k 
i 
i 5 
Options 
Speaker Pan 0.00% — $2. 
Battery 95.00% [è] |- 


Upright Wii Remote 
Sideways Wii Remote 


| X Close 
-L 
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scripting features. Further documentation available at 


ey The control panel itself is intuitive and easy to follow, but has extremely powerful 
https://dolphin-emu.org/docs/guides/configuring-controllers/#Emulated_Wii_Remote. 


And now your controller is remapped in Dolphin. The profile used will be the last selected profile in 
Dolphin's controller configuration menu for that controller when no game-specific profile specifies 
otherwise. 


GameCube 


You can configure the controls for this system within its own controller configuration utility (mouse 
and keyboard required). On the system menu, open Files with [F1] on the keyboard and navigate to 
Applications ^ dolphin-config. This will open Dolphin's menu. 


&@@@ae@@ 


a 


€&@a@aeeceee eee 


GaG 


= 
5 2 1-213 1 
= am 


From here, navigate to Controllers in the toolbar (or press F1 on the keyboard). 
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Click on the Configure button for Port 1 of the GameCube Controllers. You'll notice that it has a 
bunch of “Button #” already assigned; this is the default configuration of Dolphin and is unrelated to 
your current controller. 


Device Reset Profile 
evdev/O/Microsoft X-Box 360 pad - Refresh | Default Clear -* Load Save Delete 
GameCube Controller 
Buttons Control Stick C Stick Triggers 
| ^ | ' 
^ Button 0 p SON | L-Analog | | L 
p Button 2 / \ 
( LI ) | R-Analog | | R 
x Button 1 Y 4 
| L Axis 2+ 
Y Button 3 l | 
R Axis 5+ 
Zz Button 5 Calibrate - Calibrate - 
L-Analog Axis 2* 
START Button 7 Up Axis 1- Up Axis 4- 
R-Analog Axis 5+ 
Hotkey Button 8 Down Axis 1+ Down Axis 4+ 
Dead Zone 0.00% 
Left Axis 0- Left Axis 3 
Thresh: 0 9 ° 
Right Axis 0+ Right Axis 3+ rashoki (90.009 
D-Pad Modifier Modifier Rumble 
Up Axis 7- Dead Zone 0.00% 7 Dead Zone 000% $ Motor 
Down Axis 7+ Virtual Notches | 0.00 * cs Virtual Notches | 0.00 * — 
Left Axis 6- 
: Options 
Right Axis 6+ 
Always Connected 
X Close 


You can configure system controls by clicking on them and pressing a button on your controller. Let's 
say | had a SNES-style pad and wanted the labels to match the game's inputs, | would reassign it like 
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SO: 


Device Reset Profile 


evdev/0/Microsoft X-Box 360 pad - Refresh Default Clear - Load Save Delete 


GameCube Controller 


Buttons Control Stick C Stick Triggers 
A EAST | | L-Analog | L 
UTH | i | 
i = = | | R-Analog | R 
x WEST | T are 
| L Full Axis 2+ 
y NORTH = COP SE 
- R Full Axis 5+ 
Z TR Calibrate M Calibrate xd 
L-Analog Full Axis 2+ 
START START Up Axis 1- Up Axis 4- 
R-Analog Full Axis 5+ 
Hotkey MODE Down Axis 1+ Down Axis 4* 
Dead Zone | 0,00 % = 
Left Axis 0- Left Axis 3- 
l : < 
Right Axis 0+ Right Axis 3+ Tweed 96.009 
D-Pad Modifier Modifier Rumble 
Up Axis 7- Dead Zone 0.00 % AIS Dead Zone 0.00 % els Motor 
Down Axis 7+ Virtual Notches 0.00" - Virtual Notches |. 0.00 * - 
Left Axis 6- 
Options 
Right Axis 6* 


Always Connected 


X Close 


You'll notice that the buttons on your controller will turn into cardinal directions. This is the lingo used 
by Batocera to unify all the various controllers you can connect to it. You might also want to calibrate 
your sticks, as l've done here, and maybe increase the trigger threshold (good controllers should be 
able to go all the way up to 9996 with no trouble!). You should also probably reassign the trigger 
axises so the triggers use the full axis instead of only a partial amount of it. 


Once you're done, type a name into the Profile field at the top right and click Save. 
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-——— ———MÀnL II 
Device Reset Proja 
evdev/O/Microsoft X-Box 360 pad * Refresh Default Clear custom M Los Save Delete 
GameCube Controller 
Buttons Control Stick C Stick Thggers 
E EAST L-Analog L 
SOUTH 
B SOL R-Analog R 
X WEST 
L Full Axis 2+ 
Y NORTH 
R Full Axis 5+ 
Z TR Calibrate - Calibrate " 
L-Analog Full Axis 2+ 
START START Up Axis 1- Up Axis 4- 
R-Analog Full Axis 5+ 
Hotkey MODE Down Axis 1+ Down Axis 4+ 
Dead Zone 0.00 % 
Left Axis 0 Left Axis 3 
Threshold 96.00 % > 
Right Axis 0+ Right Axis 3+ 
D-Pad Modifier Modifier Rumble 
Up Axis 7- Dead Zone 0.00 % - Dead Zone 0.00 % - Motor 
Dowr Axis 7+ Virtual Notches 0.00 - Virtual Notches 0.00 
Left Axis 6 
Options 
Right Axis 6+ 
Always Connected 
X Close 


Click Close on all the windows and then File > Quit to leave Dolphin. 


Now, before you launch any GameCube/Wii game, open the ADVANCED SYSTEM OPTIONS by 
pressing [SELECT] on the GameCube's game list screen. 


VIEW OPTIONS 


DPT ION 


ADVANCED SYSTEM OPTIONS 


And set USE PAD PROFILES to “ON”. If you don't do this, your profile will be ignored. 
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NINTENDO GAMECUBE 


And now your controller is remapped in Dolphin. The profile used will be the last selected profile in 
Dolphin's controller configuration menu for that controller when no specifies 
otherwise. 


; , The control panel itself is intuitive and easy to follow, but has extremely powerful 
X y scripting features. Further documentation available at 


Save per-game remap profiles 


Controller remaps can be applied to specific games via dolphin-emu-config as well. 


After creating and saving a custom profile, go back to Dolphin's main menu and right click on the 
game you'd like to use the custom profile for. 
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Go into Properties. 


Mario Kar Doute Dash iso' GV2EUT - Mario Kart Coube Dashi! 


| Game Config Patches AR Codes Gecko Codes info Verify 


General Editor 


Game-Specific Settings 


These settings override core Dolphin settings. 
Undetermined means the game uses Do!phin's setting. 


Core 


@ Enable Dual Core 

@ Enable MMU 

Bl Enable FPRF 

E Synchronize GPU thread 

@ Speed up Disc Transfer Rate 

@ DSP HLE (fast) 

Deterministic dual core: Not Set 


Stereoscopy 


Depth Percentage: E. 


TEEN Mere 
OM Games / LOD Dite Parure) 

Mec entertainment 

Action 

Terona ats 

tindera Art 

Take Tao interactive | (arme Tob | Pockuta: Gurwen / Gabai Star Softens 
Tahe Teo teractive | Garve Tab. | Rockstar Garsen / Gobel Star Software 


Tobe Amo interactive | Gama teh | Achatar Der | Pobal Star SP 


Dent ame PAAR Rade Gates 


here ast 
Durey ventes Saudos | Buena vata Garret 


LL 


Convergence- | 392 


ll Monoscopic Shadows 


Go into Editor. 
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Mario Kart Double Dash ico: GM4E01 Mano Kart Double Dashit 


Game Config Patches AR Codes Gecko Codes info Verify Files) >? 


General = 
Default Config (Read Only) 
GM4.ini | GM4EOL.ini | 
Presets 
* GM4E01, GM4JO1. GMAPO] - Mano Kart: Double Dash'! 


[Core] 


# Values set here will overnde the main Dolphin settings 


[OnLoad] 
# Add memory patches to be loaded once on boot here 


[OnFrame] 


db Add mama natrhec tn he annliad auand frame hara 


User Config 


GM4E01 ini 


Presets 


[Controls] 
PadProfilel = Double Dash 


Then in the "User Config" text box, ensure the dropdown menu is set to "Presets" and type the 
following into the window: 


[Controls] 
PadProfilel - «profile» 


where «profile» is the name of the custom profile you'd like to use for that game. 


For setting this profile for more than just player 1, append the following: 


PadProfile2 = «profile» 
PadProfile3 - «profile» 
PadProfile4 - «profile» 


Not all players have to use the same profile. An example user config might look like this: 


[Controls] 

PadProfilel - triggers on L2 R2 
PadProfile2 - triggers on L2 R2 
PadProfile3 - triggers on L1 R1 
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PadProfile4 - Peters super cool custom config 


Controllers with only one analog stick 


If your controller has only one analog stick (Odroid Go Advance, or if you have a Dreamcast or N64- 
style gamepad for example) and you want to use an emulator that by default uses the D-pad as the 
system's controller and the second analog as the system's mouse. You can edit the 
/userdata/system/batocera.conf and add the following lines in order to have the left analog as 
the system's mouse: 


amigal200.retroarch.input playerl analog dpad mode-1 
amigal200.retroarch.input player2 analog dpad mode-1 
amiga500.retroarch.input playerl analog dpad mode-1 
amiga500.retroarch.input player2 analog dpad mode-1 
c64.retroarch.input playerl analog dpad mode-1 
c64.retroarch.input player2 analog dpad mode-1 


Cores like LR-PUAE and Vice (and some others like Flycast etc...) will then map the left analog on your 
RetroPad to the system's mouse (RetroArch only). 


Reconfiguring the Keyboard for RetroArch 


If you'd like to reconfigure the default keyboard bindings for all systems emulated by a libretro core 
(such as if you don't have a controller to use or you're in an all-in-one device like a netbook), refer to 
the keyboard controls section of the advanced RetroArch settings page instead. 


Default light gun mappings 


Here are the default light gun mappings, in case you're configuring an emulator which does not 
support "press the button to map" remapping functionality: 


PT Wiigun Wiigun code Sinden Sinden GUN4IR GUN4IR AimTrack|AimTrack |AElightgun AElightgun DDolphinbar|Dolphinbar|GunCon2|GunCon2 
Et button 9 button code button code button |code button code button code button |code 

BTN LEFT B BTN EAST Trigger BTN LEFT Trigger BTN LEFT Trigger  |BTN LEFT Trigger BTN LEFT |B BTN LEFT Trigger |BTN LEFT 
BTN RIGHT ^ BTN soUTH HaT P T9" UgTN RIGHT Offscreen/A/C BTN RIGHT Right side BTN RIGHT Left mouse BTN RIGHT |A BTN RIGHT |C BTN RIGHT 
BTN MIDDLE PLUS KEY NEXT Back left ||BTN MIDDLEB BTN MIDDLE Left side |BTN MIDDLE iiu BTN MIDDLEI- - START BTN MIDDLE 
BIN 1 MINUS |KEY PREVIOUS Front right |KEY 1 START KEY 1 - 1 BIN 1 - - SELECT |BTN 1 

BTN 2 1 BTN 1 Back right |KEY 2 SELECT KEY 5 - - 2 BTN 2 - - A BTN 2 

BTN 3 2 BTN 2 - - - - E - 3 BTN 3 - E BTN 3 

BTN 4 HOME |BTN MODE l- - B - - - 4 BTN 4 - - - - 

BTN 5 1 KEY UP 1 KEY UP 1 KEY UP B Up KEY. UP = B 1 5 

BTN 6 i KEY DOWN i KEY DOWN 1 KEY DOWN |- - Down KEY DOWN |- - 1 6 

BTN 7 - KEY LEFT - KEY LEFT le KEY LEFT - - E = E - 7 

BTN 8 2 KEY RIGHT |> KEY RIGHT | KEY RIGHT |- - - - - - 2 8 
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